home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / WWW / HSC0916.ZIP / !ReadMe
Text File  |  1998-05-01  |  3KB  |  73 lines
  1. Notes for the RISC OS port (1.00)
  2. ---------------------------------
  3.  
  4. In order to use 'hsc' it seems sensible to use a filing system that supports
  5. long filenames since some files in this distribution archive (and also in the
  6. source archive) have names up to 20 characters long. This means that you
  7. should use something like LongFiles to obtain more than 10 characters from a
  8. standard FileCore FS (eg. ADFS, SCSIFS, IDEFS, etc.) or use a separate filing
  9. system (eg. raFS) or some sort of image filing system (eg. X-Files).
  10.  
  11. The program 'PDMake' is supplied in this distribution and should be used in
  12. preference to 'amu' (Acorn Make Utility) to handle makefiles. In fact, due to
  13. the way HTML filenames are handled on RISC OS by the various browsers, the
  14. makefile should use names in Unix notation (eg. ../MyHTML/hsc.html
  15. corresponding to ^.MyHTML.hsc/html under RISC OS) but 'amu' and other ports
  16. of GNU 'make' seems to handle the extensions in the wrong way (ie. as in C
  17. programs where 'sources/hsc.c' must be converted to 'sources.c.hsc').
  18.  
  19. The original sources should compile on RISC OS without modifications. Please
  20. read the instructions supplied in the 'riscos' directory of the sources
  21. archive for more informations about the compilation.
  22.  
  23. The <$exec> tag doesn't work very well in the RISC OS port. To make it work
  24. you can use something like:
  25.  
  26. <$exec COMMAND="command { > RAM:$.tmp }" TEMPORARY INCLUDE FILE="RAM:$/tmp">
  27.                             ^^^^^^^^^                            ^^^^^^^^^
  28.                             RISC OS style                        Unix style
  29.  
  30. Remember to add 'PRE' and 'SOURCE' as needed (see documentation of <$include>
  31. for more informations).
  32.  
  33. The examples supplied in the 'examples' and 'docs-source' directory should
  34. work using 'PDMake'. The 'grafflwerk' directory mentioned in the docs is not
  35. supplied in this distribution because it contains ARexx-scripts which won't
  36. work with RISC OS.
  37.  
  38.  
  39.  
  40. Updates
  41. -------
  42.  
  43. The latest version of the RISC OS port of 'hsc' should be available from the
  44. authors' WWW pages:
  45.  
  46. http://www.alphawave.ltd.uk/sergio/hsc.html
  47. http://www.axis.demon.co.uk/hsc/
  48.  
  49. The documentation (HTML online and Postscript) and the sources are only
  50. available from the hsc-support-w3-page:
  51.  
  52. http://www.giga.or.at/~agi/hsc/
  53.  
  54.  
  55. Contacting the authors of the RISC OS port
  56. ------------------------------------------
  57.  
  58. Please contact us if your problem seems to be specific to the RISC OS port,
  59. contact the author (Thomas Aglassinger, see main docs files for email
  60. address) if the problem regards 'hsc' in general.
  61.  
  62.  
  63.        Sergio Monesi                          Nick Craig-Wood
  64.  
  65. EMail: msergio@tin.it                         ncw@axis.demon.co.uk
  66.        pel0015@cdc8g5.cdc.polimi.it           nick@craig-wood.com
  67.        sergio@freebsd.first.gmd.de            ncw@alphawave.ltd.uk
  68.  
  69. WWW:   http://bounce.to/sergio                http://www.axis.demon.co.uk/
  70.        http://www.alphawave.ltd.uk/sergio/    http://www.alphawave.ltd.uk/ncw/
  71.  
  72.  
  73.